Návod k editaci JSON šablony — Dokument (faktura, dodací list)

Tento návod je určen pro úpravu JSON šablon obchodních dokumentů (faktury, dodací listy, objednávky, nabídky) ve VS Code s live preview.

Obsah:

• Jak to funguje · Editace ve VS Code · Princip: bloky
• 1. Nastavení dokumentu · 2. Záhlaví/zápatí stránky · Přehled bloků
• 3. header-two-column · 4. info-grid · 5. table · 6. form-table
• 7. total-amount · 8. text-block · 9. signature · 10. separator · 11. spacer
• 12. image · 13. qr-code · 14. barcode · 15. columns
• 16. Podmíněná viditelnost · 17. Tečková notace · 18. Aliasy
• 19. Opakování dokumentu · 20. ShowProgress · 21. Generování z FRX · 22. Inventarizační protokoly
• 23. Skupiny v tabulce
• Příklad faktury · Řešení problémů · Časté úpravy · Tipy pro VS Code

Jak to funguje

┌───────────────────────────────────────────────────────────┐
│  XML data         +    JSON šablona    →    HTML / PDF    │
│  (z aplikace)          (vaše úpravy)        (výstup)      │
└───────────────────────────────────────────────────────────┘

XML data — připraví aplikace. Obsahují data dokumentu: dodavatel, odběratel, položky, ceny.

JSON šablona — tu upravujete vy. Říká rendereru, jak má dokument vypadat: jaké bloky, v jakém pořadí, s jakými daty.

Výstup — HTML (náhled), PDF (tisk/email).

Editace ve VS Code

Editaci spustíte z aplikace. Otevře se VS Code s JSON souborem a v prohlížeči se zobrazí HTML náhled.

Základní workflow

1. Otevřete editaci z aplikace (tlačítko "Upravit šablonu")
2. VS Code se otevře se JSON souborem, v prohlížeči se zobrazí náhled
3. Upravte JSON šablonu ve VS Code
4. Uložte (Ctrl+S) — náhled v prohlížeči se automaticky obnoví za ~2 sekundy
5. Zkontrolujte výsledek v prohlížeči
6. Opakujte kroky 3–5

VS Code nápověda

• Ctrl+Space — zobrazí dostupné vlastnosti
• Najetí myší — zobrazí popis vlastnosti
• Červené podtržení = chyba v JSON

Pozor: JSON soubor musí být validní. Nejčastější chyba: čárka za poslední položkou v {} nebo []. VS Code chybu červeně podtrhne.

Princip: Dokument = posloupnost bloků

Na rozdíl od tabulkové sestavy (kde je jedna velká tabulka), dokument se skládá z bloků, které se řadí shora dolů. Každý blok má svůj typ a vlastnosti.

{
  "renderer":   "document",  ← typ šablony (volitelné, pro jednoznačnou identifikaci)
  "aliases":    { ... },     ← zkratky pro dlouhé XML cesty (volitelné)
  "document":   { ... },     ← nastavení dokumentu
  "pageHeader": { ... },     ← záhlaví stránky (opakuje se)
  "pageFooter": { ... },     ← zápatí stránky (opakuje se)
  "blocks": [                ← pole bloků — v tomto pořadí se vykreslí
    { "type": "header-two-column", ... },
    { "type": "info-grid", ... },
    { "type": "table", ... },
    { "type": "total-amount", ... },
    { "type": "signature", ... }
  ]
}

1. Nastavení dokumentu (document)

{
  "document": {
    "title": "FAKTURA – daňový doklad",
    "culture": "cs-CZ",
    "orientation": "portrait",
    "pageSize": "A4",
    "pageMarginMm": 8,
    "overflow": "auto"
  }
}

Režimy stránkování (overflow)

Tip: Pro faktury použijte "auto" — krátké faktury se vejdou na 1 stránku, dlouhé se automaticky roztáhnou do přílohy.

Rozvaha a podobné výkazy: Použijte "paged" — každá tabulka se automaticky stránkuje řádek po řádku, záhlaví tabulky se opakuje na každé stránce.

Příklad: Rozvaha se dvěma tabulkami (aktiva/pasiva) v paged mode

{
  "renderer": "document",
  "document": {
    "title": "{header.title}",
    "culture": "cs-CZ",
    "pageMarginMm": 8,
    "overflow": "paged",
    "fontSizePt": 8
  },
  "pageHeader": {
    "left": "{header.title}",
    "right": "Strana {page}",
    "heightMm": 8,
    "fromPage": 2
  },
  "blocks": [
    {
      "type": "table",
      "element": "data",
      "where": "lk1=A",
      "headerRows": [
        [
          { "text": "Označ.", "rowspan": 2, "align": "center" },
          { "text": "A K T I V A", "rowspan": 2 },
          { "text": "Číslo\nřádku", "rowspan": 2, "align": "center" },
          { "text": "Běžné účetní období", "colspan": 3, "align": "center" },
          { "text": "Minulé úč.\nobdobí", "rowspan": 2, "align": "center" }
        ],
        [
          { "text": "Brutto", "align": "center" },
          { "text": "Korekce", "align": "center" },
          { "text": "Netto", "align": "center" }
        ]
      ],
      "columns": {
        "klic_tisk": { "label": "k", "width": "13mm" },
        "nazev":     { "label": "Název", "width": "60mm", "maxWidth": "60mm" },
        "radek":     { "label": "ř.", "align": "center", "format": "N0", "suppressRepeat": true, "width": "10mm" },
        "brutto":    { "label": "Brutto", "align": "right", "format": "{prnobj.format}", "hideZero": true, "width": "25mm" },
        "korekce":   { "label": "Korekce", "align": "right", "format": "{prnobj.format}", "hideZero": true, "width": "25mm" },
        "netto":     { "label": "Netto", "align": "right", "format": "{prnobj.format}", "hideZero": true, "width": "25mm" },
        "loni":      { "label": "Loni", "align": "right", "format": "{prnobj.format}", "hideZero": true, "width": "25mm" }
      }
    },
    {
      "type": "table",
      "element": "data",
      "where": "lk1=P",
      "pageBreakBefore": true,
      "columns": {
        "klic_tisk": { "label": "k", "width": "13mm" },
        "nazev": { "label": "Název", "width": "80mm", "maxWidth": "100mm" },
        "radek": { "label": "ř.", "align": "center", "suppressRepeat": true, "width": "10mm" },
        "netto": { "label": "Netto", "align": "right", "format": "{prnobj.format}", "hideZero": true, "width": "35mm" },
        "loni":  { "label": "Loni", "align": "right", "format": "{prnobj.format}", "hideZero": true, "width": "35mm" }
      }
    }
  ]
}

Klíčové prvky rozvahy:

• "overflow": "paged" — stránkování řádek po řádku
• "where": "lk1=A" / "where": "lk1=P" — filtrování aktivních/pasivních řádků ze sdíleného elementu data
• "format": "{prnobj.format}" — dynamický formát čísla (N0/N2) z XML atributu prnobj.format
• "suppressRepeat": true na sloupci radek — čísla řádků se zobrazí jen při změně
• "maxWidth": "60mm" — zalamování dlouhých názvů
• "pageBreakBefore": true na druhé tabulce — pasiva vždy začínají na nové stránce

2. Záhlaví/zápatí stránky (pageHeader / pageFooter)

Opakuje se na každé stránce (v režimech continue, auto/attachment):

{
  "pageHeader": {
    "left": "EFES spol. s r.o.",
    "center": "",
    "right": "Strana {page} z {pages}",
    "fromPage": 2
  },
  "pageFooter": {
    "center": "Vytištěno: {date}"
  }
}

fromPage: 2 — záhlaví se zobrazí až od 2. stránky (1. stránka má vlastní hlavičku).

Přehled typů bloků (13)

3. Blok header-two-column — dodavatel a odběratel

{
  "type": "header-two-column",
  "ratio": "50:50",
  "left": {
    "title": "DODAVATEL",
    "element": "dodavatel",
    "logo": { "file": "logo.jpg", "maxWidthMm": 30, "position": "left" },
    "fields": [
      { "field": "nazev", "style": "title" },
      { "field": "ulice" },
      { "template": "{psc}  {mesto}" },
      { "separator": true },
      { "label": "IČO", "field": "ico" },
      { "label": "DIČ", "field": "dic" }
    ]
  },
  "right": {
    "title": "ODBĚRATEL",
    "element": "odberatel",
    "bordered": true,
    "fields": [
      { "field": "nazev", "style": "title" },
      { "field": "ulice" },
      { "template": "{psc}  {mesto}" },
      { "separator": true },
      { "label": "IČO", "field": "ico" },
      { "label": "DIČ", "field": "dic", "visibleWhen": "odberatel.dic" }
    ]
  }
}

Vizuální schéma

┌─────────────────────────┬───────────────────────────┐
│ DODAVATEL               │ ┌─ODBĚRATEL─────────────┐ │
│ [logo] EFES spol. s r.o.│ │ BAKPA INVEST s.r.o.   │ │
│        Neklanova 18     │ │ Komoranská 2428/17    │ │
│        128 00 Praha 2   │ │ 143 00 Praha 4        │ │
│ ──────────────────────  │ │ ────────────────────  │ │
│ IČO: 13150529           │ │ IČO: 07240244         │ │
│ DIČ: CZ6209260915       │ │                       │ │
│                         │ └───────────────────────┘ │
└─────────────────────────┴───────────────────────────┘

Vlastnosti sloupce (left/right)

Pole (fields) — typy řádků

{ "field": "nazev", "style": "title" }     ← hodnota z XML, tučně
{ "field": "ulice" }                        ← hodnota z XML
{ "label": "IČO", "field": "ico" }         ← popisek + hodnota
{ "template": "{psc}  {mesto}" }            ← šablona z více polí
{ "separator": true }                       ← oddělovací čára
{ "type": "spacer", "heightMm": 5 }        ← prázdný prostor

Tip: Pokud je XML hodnota prázdná, řádek se automaticky skryje (včetně popisku). Pokud chcete zobrazit i prázdný řádek, použijte template místo field.

Logo

{
  "logo": {
    "file": "C:\\data\\logo.jpg",
    "maxWidthMm": 30,
    "position": "left"
  }
}

4. Blok info-grid — mřížka klíč-hodnota

{
  "type": "info-grid",
  "element": "doklad",
  "columns": 2,
  "labelWidth": "40%",
  "borderless": true,
  "items": [
    { "label": "Číslo faktury",     "field": "cislo",     "style": "title" },
    { "label": "Variabilní symbol", "field": "vs" },
    { "separator": true },
    { "label": "Způsob úhrady",     "template": "Příkazem k úhradě" },
    { "label": "Den splatnosti",    "field": "splatnost", "format": "dd.MM.yyyy", "style": "bold" },
    { "label": "Den vystavení",     "field": "vystaveni", "format": "dd.MM.yyyy" }
  ]
}

Vizuální schéma

┌──────────────────────────────────────────────────────────┐
│ Číslo faktury:  FV2600244     Variabilní symbol: 2600244 │
│ ──────────────────────────────────────────────────────── │
│ Způsob úhrady: Příkazem      Den splatnosti: 16.02.2026 │
│                               Den vystavení:  02.02.2026 │
└──────────────────────────────────────────────────────────┘

Položka info-grid

Info-grid v praxi (XML → JSON → výstup)

XML data:

<doklad cislo="FV2600244" vs="2600244" splatnost="2026-02-16" />

JSON definice:

{
  "type": "info-grid", "element": "doklad", "columns": 2,
  "items": [
    { "label": "Číslo faktury", "field": "cislo", "style": "title" },
    { "label": "VS", "field": "vs" },
    { "label": "Splatnost", "field": "splatnost", "format": "dd.MM.yyyy", "style": "bold" }
  ]
}

Výstup:

Formulářový styl (fieldStyle: "form")

Pro úřední formuláře (daňová přiznání apod.) kde potřebujete popisek nahoře a orámovaný textbox pod ním:

{
  "type": "info-grid",
  "element": "hlavicka",
  "columns": 2,
  "fieldStyle": "form",
  "items": [
    { "label": "Finančnímu úřadu pro", "field": "nazev_fu" },
    { "label": "DIČ", "field": "dic", "style": "bold" }
  ]
}

Finančnímu úřadu pro        DIČ
┌──────────────────┐        ┌──────────────────┐
│ hlavní město     │        │ CZ41189710       │
└──────────────────┘        └──────────────────┘

Klíčové vlastnosti:

• fieldStyle": "form" — zapne formulářový režim
• Prázdná pole se nezakrývají — zobrazí se jako prázdné orámované boxy
• heightMm na položce nastaví minimální výšku rámečku (např. "heightMm": 25 pro razítkový prostor)

Styl form-inline — popisek vlevo, textbox vpravo

{
  "type": "info-grid",
  "element": "hlavicka",
  "fieldStyle": "form-inline",
  "columns": 3,
  "items": [
    { "label": "řádné", "field": "cb_radne", "style": "bold", "width": "10mm" },
    { "label": "dodatečné", "field": "cb_dodatecne", "width": "10mm" },
    { "label": "opravné", "field": "cb_opravne", "width": "10mm" }
  ]
}

řádné ┌──┐   dodatečné ┌──┐   opravné ┌──┐
      │ X│             │  │           │  │
      └──┘             └──┘           └──┘

Na rozdíl od "form" (label nahoře, box dole), "form-inline" umístí popisek vlevo a orámovaný textbox vpravo na jednom řádku. Typické pro formuláře typu DPH přiznání.

Kompaktní řádkování (compact)

{
  "type": "info-grid",
  "element": "hlavicka",
  "compact": true,
  "items": [ ... ]
}

Vlastnost compact: true zmenší padding a řádkování v info-gridu. Užitečné pro formuláře s mnoha řádky.

5. Blok table — tabulka s položkami

{
  "type": "table",
  "element": "polozky",
  "primary": true,
  "showRowNumbers": true,
  "columns": {
    "nazev":  { "label": "Název",     "align": "left" },
    "pocet":  { "label": "Množství",  "align": "right", "format": "N2", "width": "60px" },
    "mj":     { "label": "MJ",        "align": "center", "width": "30px" },
    "jc":     { "label": "Cena/ks",   "align": "right", "format": "N2", "width": "80px" },
    "cena":   { "label": "Celkem",    "align": "right", "format": "N2", "width": "90px" }
  },
  "sumExpressions": [
    { "field": "cena", "expr": "SUM(cena)", "format": "N2" }
  ],
  "sumLabel": "Celkem"
}

Vizuální schéma

┌────┬──────────────────────┬──────────┬─────┬──────────┬───────────┐
│ #  │ Název                │ Množství │ MJ  │ Cena/ks  │ Celkem    │
├────┼──────────────────────┼──────────┼─────┼──────────┼───────────┤
│ 1  │ Služby VT            │    40,00 │ h   │ 1 815,00 │ 72 600,00 │
│ 2  │ Správa serveru       │     1,00 │ ks  │ 2 420,00 │  2 420,00 │
├────┼──────────────────────┼──────────┼─────┼──────────┼───────────┤
│    │ Celkem               │          │     │          │ 75 020,00 │
└────┴──────────────────────┴──────────┴─────┴──────────┴───────────┘

headerRows — víceřádkové záhlaví tabulky

Pokud tabulka potřebuje složitější záhlaví (např. rozvaha se sloučenými buňkami), použijte headerRows. Každý prvek pole = jeden řádek záhlaví, každý řádek = pole buněk.

{
  "type": "table",
  "element": "aktiva",
  "headerRows": [
    [
      { "text": "Označ.", "rowspan": 2 },
      { "text": "A K T I V A", "rowspan": 2 },
      { "text": "Číslo\nřádku", "rowspan": 2 },
      { "text": "Běžné účetní období", "colspan": 3, "align": "center" },
      { "text": "Minulé úč.\nobdobí", "rowspan": 2, "align": "center" }
    ],
    [
      { "text": "Brutto\n1", "align": "center" },
      { "text": "Korekce\n2", "align": "center" },
      { "text": "Netto\n3", "align": "center" }
    ]
  ],
  "columns": { ... }
}

Vlastnosti buňky záhlaví:

Tip: Pokud headerRows chybí, záhlaví se generuje automaticky z columns[].label (jednořádkové) — zpětná kompatibilita.

Sloupce tabulky — stejné jako v tabulkové sestavě

Sloupce dokumentové tabulky mají stejné vlastnosti jako v tabulkové sestavě: label, align, format, width, maxWidth, hide, hideZero, suppressRepeat, expr, round, running, template, visibleWhen.

Tabulka v praxi (XML → JSON → výstup)

XML data:

<polozky>
  <row nazev="Služby VT" pocet="40" mj="h" jc="1815" cena="72600" />
  <row nazev="Správa serveru" pocet="1" mj="ks" jc="2420" cena="2420" />
</polozky>

JSON definice:

"columns": {
  "nazev": { "label": "Název" },
  "pocet": { "label": "Mn.", "align": "right", "format": "N2" },
  "jc":    { "label": "Cena/ks", "align": "right", "format": "N2" },
  "cena":  { "label": "Celkem", "align": "right", "format": "N2" }
}

Výstup:

SubFields — doplňkový řádek pod položkou

{
  "subFields": [
    { "field": "ean",      "label": "EAN" },
    { "field": "sarze",    "label": "Šarže" },
    { "field": "poznamka" }
  ]
}

│ 1  │ Služby VT                    │  40,00 │ h  │ 72 600,00 │
│    │ EAN: 8594001234567 | Šarže: L2026-01                    │

SubFields se zobrazí na druhém řádku pod hlavním. Pokud jsou všechny prázdné, řádek se nevykreslí.

SubFields podporují Markdown s prefixem ^ (viz blok text-block).

Cross-element přístup (tečková notace) v tabulce

Sloupec tabulky může přistupovat k hodnotám z jiného XML elementu:

{
  "columns": {
    "cizi":    { "label": "Cena {header.mena}", "format": "N2" },
    "prepocet": { "label": "Cena Kč", "expr": "cizi * header.kurz", "format": "N2" },
    "s_menou": { "label": "Celkem",  "template": "{cena:N2} {header.mena}" }
  }
}

• header.mena — hodnota atributu mena z XML elementu <header>
• Tečková notace funguje v expr, template i label

Tečková notace funguje i v dalších blocích — viz sekci 17.

6. Blok form-table — formulářová tabulka

Blok form-table slouží pro tisk formulářů s pevně danými řádky — typicky daňová přiznání (DPH, silniční daň apod.). Na rozdíl od bloku table, kde řádky pocházejí z XML dat, zde jsou řádky definované přímo v JSON a data se doplňují z XML přes klíč (keyField).

Vizuální schéma

┌────────────────────────────────────────────────────────────────┐
│ I. Zdanitelná plnění                                           │
├──────────────────────────────────────┬────┬──────────┬─────────┤
│ Dodání zboží (§13, §14)    základní │  1 │ 1 752 218│  367 966│
│                             snížená │  2 │72 591 721│8 711 007│
│ Pořízení z JČS (§16)       základní │  3 │         0│        0│
│                             snížená │  4 │49 637 566│5 956 508│
└──────────────────────────────────────┴────┴──────────┴─────────┘

Základní struktura

{
  "type": "form-table",
  "element": "dph",
  "keyField": "r1",
  "sections": [
    {
      "title": "I. Zdanitelná plnění",
      "columns": {
        "popis": { "width": "53%" },
        "sazba": { "width": "8%", "fontSize": 7, "align": "center" },
        "radek": { "label": "ř.", "width": "4%", "align": "center" },
        "s2":    { "label": "Základ daně", "width": "17%", "align": "right", "format": "N0" },
        "s3":    { "label": "Daň na výstupu", "width": "18%", "align": "right", "format": "N0" }
      },
      "rows": [
        {
          "popis": { "value": "Dodání zboží (§13, §14)", "rowspan": 2 },
          "sazba": "základní", "radek": "1", "_key": "001"
        },
        { "sazba": "snížená", "radek": "2", "_key": "002" }
      ]
    }
  ]
}

Klíčové vlastnosti bloku

Sekce

Každá sekce má vlastní nadpis, sloupce a řádky:

Sloupce

Sloupce se definují jako objekt — klíč = název, hodnota = vlastnosti:

Řádky

Každý řádek je objekt. Klíče odpovídají sloupcům. Speciální klíče začínají _:

Hodnoty buněk

Hodnota buňky může být:

Prostý text/číslo — hodnota z JSON nebo doplněná z XML:

{ "sazba": "základní", "radek": "1", "_key": "001" }

Objekt s vlastnostmi — pro rowspan, colspan, formát, zarovnání:

{
  "popis": { "value": "Dodání zboží (§13, §14)", "rowspan": 2 },
  "sazba": "základní"
}

Jak funguje párování s XML

1. V JSON definujete řádek s "_key": "001"
2. Renderer hledá v XML element s keyField hodnotou "001":

   <dph>
     <row r1="001" s2="1752218" s3="367966"/>
   </dph>
   

3. Datové sloupce (s2, s3) se doplní z nalezeného XML řádku
4. Textové sloupce (popis, sazba, radek) zůstanou z JSON
5. Pokud XML řádek neexistuje, datové buňky zůstanou prázdné

Pozor: Hodnoty _key v JSON musí přesně odpovídat hodnotám keyField v XML. Pokud se data nezobrazují, zkontrolujte, že se klíče shodují (včetně mezer a formátu čísla).

Příklad: Sekce s různými sloupci

Různé sekce mohou mít různé sloupce (např. sekce I má 5 sloupců, sekce II jen 3):

{
  "title": "II. Ostatní plnění",
  "columns": {
    "popis": { "width": "74%" },
    "radek": { "label": "ř.", "width": "4%", "align": "center" },
    "s3":    { "label": "Hodnota", "width": "22%", "align": "right", "format": "N0" }
  },
  "rows": [
    { "popis": "Dodání zboží do JČS (§64)", "radek": "20", "_key": "020" },
    { "popis": "Vývoz zboží (§66)", "radek": "22", "_key": "022" }
  ]
}

Sekce bez záhlaví

Některé sekce nepotřebují opakovat záhlaví sloupců — použijte "showHeader": false:

{
  "title": "V. Krácení nároku na odpočet daně",
  "showHeader": false,
  "columns": { ... },
  "rows": [ ... ]
}

7. Blok total-amount — celková částka

{
  "type": "total-amount",
  "element": "doklad",
  "field": "celkem_s_dph",
  "label": "Celkem k úhradě",
  "format": "N2",
  "suffix": "Kč"
}

Vizuální schéma

Celkem k úhradě .............. 75 020,00 Kč

8. Blok text-block — volný text

Statický text

{
  "type": "text-block",
  "lines": [
    "Fakturujeme Vám za dodané služby.",
    "Ceny jsou zaokrouhleny na celé Kč."
  ]
}

Dynamický text z XML

{
  "type": "text-block",
  "element": "header",
  "field": "text_pod_r"
}

Dynamický text s labelem

Label se překládá přes dictionary a zobrazí se jen pokud je pole neprázdné:

{
  "type": "text-block",
  "element": "header",
  "field": "zpracoval",
  "label": "Vyřizuje"
}

Výstup: „Vyřizuje: Marianna Dávidházy"

Šablona s placeholdery

{
  "type": "text-block",
  "element": "doklad",
  "template": "Objednávka č. {objednavka} ze dne {datum_obj:dd.MM.yyyy}"
}

Dynamické řádky

{
  "type": "text-block",
  "element": "dodavatel",
  "lines": ["{rejstrik}"],
  "style": "small"
}

Příklad — text s vlastním zarovnáním a velikostí:

{
  "type": "text-block",
  "lines": ["Strana 1"],
  "align": "center",
  "fontSize": 12
}

Markdown (prefix ^)

Textové hodnoty začínající ^ se zpracují jako Markdown:

XML:  text_pod_r="^**Důležité:** zboží je ==nereklamovatelné=="

Markdown funguje v: text-block (field, lines), subFields tabulky.

9. Blok signature — podpisy

{
  "type": "signature",
  "left": "Vystavil: {doklad.vystavil}",
  "right": "Razítko a podpis dodavatele:\nPřevzal: _______________"
}

Vizuální schéma

Vystavil: Novák Jan                    Razítko a podpis dodavatele:
                                       Převzal: _______________

10. Blok separator — čára

{ "type": "separator" }
{ "type": "separator", "style": "thick" }
{ "type": "separator", "style": "double" }

11. Blok spacer — mezera

{ "type": "spacer", "heightMm": 15 }

Vloží prázdné místo zadané výšky.

12. Blok image — obrázek

{
  "type": "image",
  "file": "logo.png",
  "maxWidthMm": 40,
  "align": "center"
}

13. Blok qr-code — QR kód

{
  "type": "qr-code",
  "template": "SPD*1.0*ACC:{ucet.iban}*AM:{doklad.celkem}*CC:CZK*MSG:Faktura {doklad.cislo}",
  "sizeMm": 30,
  "label": "QR platba"
}

14. Blok barcode — čárový kód

{
  "type": "barcode",
  "content": "8594001234567",
  "format": "EAN-13",
  "widthMm": 50,
  "heightMm": 15,
  "showText": true
}

15. Blok columns — bloky vedle sebe

Umístí libovolné bloky do sloupců vedle sebe:

{
  "type": "columns",
  "ratio": "70:30",
  "verticalAlign": "center",
  "columns": [
    {
      "blocks": [
        { "type": "table", ... }
      ]
    },
    {
      "blocks": [
        { "type": "qr-code", ... }
      ]
    }
  ]
}

Vizuální schéma

┌──────────────────────────────────┬──────────────┐
│                                  │              │
│  TABULKA POLOŽEK                 │   ┌──────┐   │
│  ┌────┬──────┬──────┐           │   │ QR   │   │
│  │ #  │ Naz. │ Cena │           │   │ kód  │   │
│  ├────┼──────┼──────┤           │   └──────┘   │
│  │ 1  │ ...  │ ...  │           │   QR platba  │
│  └────┴──────┴──────┘           │              │
│                                  │              │
└──────────────────────────────────┴──────────────┘
          70 %                          30 %

Uvnitř columns mohou být libovolné bloky, včetně dalších columns (vnořování).

Rámeček kolem sloupce (border)

{
  "type": "columns",
  "ratio": "50:50",
  "columns": [
    {
      "blocks": [ { "type": "info-grid", ... } ]
    },
    {
      "border": true,
      "blocks": [
        { "type": "spacer", "heightMm": 28 },
        { "type": "text-block", "style": "small", "lines": ["Otisk podacího razítka"] }
      ]
    }
  ]
}

Vlastnost border: true na sloupci přidá viditelný šedý rámeček (1px solid) s vnitřním paddingem. Typické pro formuláře — rámeček kolem prostoru pro razítko nebo podpis.

16. Podmíněná viditelnost (visibleWhen)

Kterýkoliv blok (nebo jeho část) můžete podmíněně skrýt/zobrazit:

{ "type": "info-grid", "visibleWhen": "header.je_cizi_mena", ... }

visibleWhen funguje na:

• blocích — celý blok se skryje
• polích v header-two-column — konkrétní řádek adresy
• položkách info-grid — konkrétní řádek mřížky
• sloupcích tabulky — celý sloupec
• subFields — konkrétní subField

17. Tečková notace — cross-element přístup

Tečková notace {element.field} umožňuje v šablonách odkazovat na hodnoty z jiného XML elementu než toho, ke kterému blok patří. Např. info-grid patří elementu doklad, ale potřebujete zobrazit měnu z elementu header.

Formát

{element.pole}           → prostá hodnota
{element.pole:N2}        → formátovaná hodnota (číslo, datum)
{element.pole:40}        → ořízne na 40 znaků
{element.pole:40.}       → ořízne na 40 + trojtečka …
{element.pole:40w}       → ořízne na poslední celé slovo ≤ 40
{element.pole:40w.}      → celé slovo + trojtečka …

• element — název XML elementu (přímý potomek root)
• pole — název atributu v daném elementu

Kde funguje

Příklady

Info-grid — měna a kurz z hlavičky:

{
  "type": "info-grid",
  "element": "doklad",
  "items": [
    { "label": "Variabilní symbol", "field": "vs" },
    { "label": "Měna", "template": "{header.mena} (kurz {header.kurz:N2})" }
  ]
}

Text-block — šablona bez vlastního elementu:

{
  "type": "text-block",
  "template": "Faktura {header.cislo} vystavena dne {header.datum:dd.MM.yyyy}"
}

Text-block — řádky s kombinací vlastního elementu a cross-element:

{
  "type": "text-block",
  "element": "dodavatel",
  "lines": [
    "Dodavatel: {nazev}",
    "Měna: {header.mena}, kurz: {header.kurz:N2}"
  ]
}

Zde {nazev} se resolvuje z elementu dodavatel, {header.mena} z elementu header.

Pravidla

• Prosté {pole} → hledá se v elementu bloku (specifikovaném v element)
• Tečkové {element.pole} → hledá se v zadaném XML elementu (přímý potomek root)
• Obě notace lze míchat v jedné šabloně: "IČO: {ico} | Měna: {header.mena}"
• Pokud hodnota neexistuje, nahradí se prázdným řetězcem

18. Aliasy pro XML cesty (aliases)

Pokud v šabloně opakovaně používáte dlouhé tečkové cesty, můžete si definovat zkratky:

{
  "aliases": {
    "dod": "faktura.dodavatel",
    "odb": "faktura.odberatel"
  },
  "blocks": [
    {
      "type": "header-two-column",
      "left": { "element": "dod", "fields": [...] },
      "right": { "element": "odb", "fields": [...] }
    }
  ]
}

• Klíč = zkratka (alias), hodnota = plná XML cesta
• Alias se automaticky nahradí plnou cestou před renderováním
• Funguje v element, visibleWhen, template, field, suffix a dalších místech
• Alias se nahrazuje i v tečkové notaci: {dod.ico} → {faktura.dodavatel.ico}

19. Opakování dokumentu (repeatElement + filterBy)

Pokud potřebujete z jedné šablony vygenerovat N dokumentů najednou (např. hromadné upomínky, dopisy zákazníkům, výzvy k úhradě), použijte repeatElement. Renderer vezme jeden XML kontejner a pro každý jeho child element vygeneruje kompletní dokument se všemi bloky.

Jak to funguje

XML data:
  <upominky>                          ← repeatElement kontejner
    <row organizace="1001" firma="Alfa" ... />   ← 1. iterace → dokument 1
    <row organizace="1002" firma="Beta" ... />    ← 2. iterace → dokument 2
  </upominky>
  <pohledavky>                        ← sdílená plochá tabulka
    <row organizace="1001" faktura="FV001" ... />
    <row organizace="1001" faktura="FV002" ... />
    <row organizace="1002" faktura="FV003" ... />
  </pohledavky>

JSON šablona:
  repeatElement: "upominky"           ← iteruj přes child elementy
  bloky: záhlaví, text, tabulka s filterBy, podpis

Výstup:
  Dokument 1 (Alfa): záhlaví Alfa + tabulka FV001, FV002 + podpis
  --- page break ---
  Dokument 2 (Beta): záhlaví Beta + tabulka FV003 + podpis

Nastavení v document

{
  "document": {
    "repeatElement": "upominky",
    "pageBreakBetween": true,
    "overflow": "flow"
  }
}

Přístup k datům aktuálního repeat prvku

V blocích můžete přistupovat k atributům aktuálního repeat prvku stejně jako k jakémukoli jinému XML elementu:

{
  "type": "header-two-column",
  "right": {
    "title": "ODBĚRATEL",
    "element": "upominky",
    "bordered": true,
    "fields": [
      { "field": "firma", "style": "title" },
      { "field": "ulice" },
      { "template": "{psc}  {mesto}" }
    ]
  }
}

• "element": "upominky" — v repeat režimu automaticky vrátí aktuální child element (ne celý kontejner)
• {firma}, {ulice} — čte se z aktuálního repeat prvku
• Elementy mimo repeat kontejner (např. dodavatel, parametr) jsou sdílené a přístupné normálně

filterBy — filtrování tabulky podle repeat prvku

Bez filterBy by tabulka zobrazila všechny řádky XML elementu. S filterBy zobrazí jen řádky odpovídající aktuálnímu záznamu:

{
  "type": "table",
  "element": "pohledavky",
  "filterBy": ["organizace"],
  "columns": {
    "faktura": { "label": "Faktura" },
    "castka": { "label": "Částka", "format": "N2", "align": "right" }
  },
  "sumExpressions": [
    { "field": "castka", "expr": "SUM(castka)", "format": "N2" }
  ]
}

filterBy: ["organizace"] znamená: zobraz jen řádky kde pohledavky.row.organizace == upominky.row.organizace.

Tři varianty zápisu filterBy

1. String — stejný název pole v obou tabulkách (nejčastější):

"filterBy": ["organizace", "mena"]

2. Objekt — různé názvy polí v tabulce a v repeat prvku:

"filterBy": [
  { "field": "org_id", "sourceField": "organizace" }
]

3. Objekt se sourceElement — zdrojová hodnota z jiného XML elementu:

"filterBy": [
  { "field": "stredisko", "sourceField": "stredisko", "sourceElement": "parametr" }
]

Vlastnosti filterBy položky

Důležité:

• Porovnání je case-insensitive a trimuje mezery na obou stranách (kompatibilita s FoxPro CHAR poli)
• Více položek v filterBy = AND logika (řádek musí splnit všechny podmínky)
• sumExpressions se počítají jen z filtrovaných řádků
• filterBy bez repeatElement nemá efekt

Přístup k prvnímu řádku filtrovaných tabulek z ostatních bloků

V kontextu repeatElement jsou pole z první filtrované věty každé tabulky dostupná v ostatních blocích (text-block, info-grid, total-amount, signature atd.) přes tečkovou notaci {element.field}:

{
  "document": { "repeatElement": "upominky" },
  "blocks": [
    {
      "type": "table",
      "element": "pohledavky",
      "filterBy": ["organizace"],
      "columns": { ... }
    },
    {
      "type": "text-block",
      "text": "Pohledávky v měně {pohledavky.mena}. Bankovní spojení: {pohledavky.banka}."
    }
  ]
}

Placeholdery {pohledavky.mena} a {pohledavky.banka} se resolvují z prvního <row> prvku tabulky pohledavky po aplikaci filterBy — tedy z první věty patřící aktuálnímu odběrateli.

Typické použití:

• Zobrazení měny nebo bankovního spojení z první pohledávky v záhlavní části dopisu
• Přístup ke konstantním polím skupiny (číslo smlouvy, měna, splatnost atd.) mimo tabulku

Poznámka: Pokud filterBy nevrátí žádný řádek pro daný repeat prvek, placeholder vrátí prázdný řetězec. Pole jsou dostupná z prvního filtrovaného řádku — pokud se v tabulce hodnota pole mění řádek od řádku, používejte jen ta pole, která jsou pro celou skupinu konstantní.

Kompletní příklad — hromadné upomínky

JSON šablona:

{
  "document": {
    "repeatElement": "upominky",
    "pageBreakBetween": true,
    "overflow": "flow"
  },
  "blocks": [
    {
      "type": "header-two-column",
      "left": {
        "title": "DODAVATEL",
        "element": "dodavatel",
        "fields": [
          { "field": "nazev", "style": "title" },
          { "field": "ulice" },
          { "template": "{psc}  {mesto}" }
        ]
      },
      "right": {
        "title": "ODBĚRATEL",
        "element": "upominky",
        "bordered": true,
        "fields": [
          { "field": "firma", "style": "title" },
          { "field": "ulice" },
          { "template": "{psc}  {mesto}" }
        ]
      }
    },
    {
      "type": "text-block",
      "element": "upominky",
      "field": "vec",
      "style": "title"
    },
    {
      "type": "table",
      "element": "pohledavky",
      "filterBy": ["organizace"],
      "columns": {
        "faktura": { "label": "Číslo dokladu" },
        "splatna": { "label": "Splatnost", "format": "dd.MM.yyyy" },
        "rozdil": { "label": "K úhradě", "format": "N2", "align": "right" }
      },
      "sumExpressions": [
        { "field": "rozdil", "expr": "SUM(rozdil)", "format": "N2" }
      ],
      "sumLabel": "Celkem"
    },
    {
      "type": "signature",
      "left": "{parametr.sidlo} dne {date}",
      "right": "{upominky.podepsal}"
    }
  ]
}

XML data:

<root>
  <dodavatel nazev="EFES spol. s r.o." ulice="Neklanova 18" psc="128 00" mesto="Praha" />
  <parametr sidlo="Praha" />
  <upominky>
    <row organizace="1001" firma="Alfa s.r.o." ulice="Hlavní 1" psc="110 00"
         mesto="Praha" vec="Upomínka č. 1" podepsal="Jan Novák" />
    <row organizace="1002" firma="Beta a.s." ulice="Vedlejší 5" psc="602 00"
         mesto="Brno" vec="Upomínka č. 2" podepsal="Jan Novák" />
  </upominky>
  <pohledavky>
    <row organizace="1001" faktura="FV001" splatna="2026-01-15" rozdil="15000" />
    <row organizace="1001" faktura="FV002" splatna="2026-02-01" rozdil="8500" />
    <row organizace="1002" faktura="FV003" splatna="2026-01-20" rozdil="42000" />
  </pohledavky>
</root>

Výstup: 2 dokumenty oddělené page-breakem:

• Dokument 1 (Alfa s.r.o.): tabulka s FV001 a FV002, suma 23 500,00
• Dokument 2 (Beta a.s.): tabulka s FV003, suma 42 000,00

20. Průběh renderování (ShowProgress)

Při generování velkých dokumentů (batch tisk faktur) lze zobrazit dialog s průběhem:

loBuilder.ShowProgress = .T.
loBuilder.Render("faktura.pdf", "sablona.json")    && dialog s průběhem
loBuilder.ShowProgress = .F.                        && zpět bez dialogu

Dialog zobrazuje číslo řádku, fázi PDF generování a tlačítko Storno pro přerušení. Property přežívá Reset() i EndBatch().

21. Generování z FoxPro FRX

Existující FoxPro FRX reporty (faktury, dodací listy) lze konvertovat na JSON šablony:

*--- Auto-detekce typu ---
loBuilder.ConvertFrxToAllFiles("C:\frx\VYDANA1A.xml", "C:\output\")

*--- Vynuceně jako dokument (pokud auto-detekce selže) ---
loBuilder.ConvertFrxToDocumentAllFiles("C:\frx\INVUCKC.xml", "C:\output\")
loBuilder.ConvertFrxToDocumentJsonFile("C:\frx\INVUCKC.xml", "C:\output\invuckc.json")

Tip: Auto-detekce rozpozná dokumenty podle výšky PageHeader a Title bandu. Pokud FRX s fakturou klasifikuje jako tabulku, použijte variantu Document v názvu metody.

Inventarizační protokoly (INVUCKC, INVUCSUM2): Automatická konverze FRX inventarizačních protokolů je podporována. Detekce rozpozná typický vzor — PageBreak, groupExpression, nízký Detail band (< 10mm) a GroupFooter s mnoha poli (≥ 10). FRX se konvertuje metodou BuildInventoryDocument(), která generuje: logo, header-two-column, tabulku s filterBy, rekapitulaci, podmíněné texty a podpisy. Více viz sekce 22.

22. Inventarizační protokoly

FRX konvertor automaticky rozpozná inventarizační protokoly (INVUCKC, INVUCSUM2 apod.) a konvertuje je jako dokumenty s repeatElement.

Detekční kritéria

FRX je klasifikován jako inventarizační protokol pokud splňuje:

• GroupHeader s PageBreak = true a neprázdným groupExpr
• Detail band s výškou < 10 mm (jen tabulka)
• GroupFooter s výškou > 20 mm a počtem polí (ObjType=8) ≥ 10 (rekapitulace, podpisy, texty)

Generovaná struktura JSON

1. image (logo)
2. header-two-column (adresa + nadpis + podnadpis)
3. separator (thick + thin)
4. table (s filterBy z groupExpression)
5. total-amount (celková částka)
6. rekapitulace (columns s info-gridy: Účetní stav, Zjištěný stav, Rozdíl)
7. podmíněné texty (visibleWhen: shoda/neshoda)
8. signature (datum + vyhotovil/schválil)

FoxPro konverze

*--- Automatická konverze ---
loBuilder.ConvertFrxToAllFiles("C:\frx\INVUCKC.xml", "C:\output\")

*--- Vynuceně jako dokument ---
loBuilder.ConvertFrxToDocumentAllFiles("C:\frx\INVUCKC.xml", "C:\output\")

Klíčové vlastnosti výstupu

• repeatElement: generováno z groupExpression — pro každý účet se opakuje celý dokument
• filterBy: detailní tabulka filtruje řádky podle účtu (z groupExpression)
• resetPageNumbers: true — každý účet má vlastní číslování stránek
• title s placeholdery: např. "Inventura účtu {ucty.ucet}" — HTML <title> se mění pro každý účet
• FoxPro groupExpression: výrazy typu padr(ucet,6) se správně parsují — funkce jako padr, padl, substr, str, left, right se ignorují a extrahuje se vnitřní název pole

23. Skupiny v document tabulce (groups + detailBorders)

Vlastnost groups umožňuje seskupit řádky plochých XML dat v tabulce dokumentu podle hodnoty atributu — podobně jako skupiny v tabulkové sestavě. Každá skupina dostane záhlaví a volitelný sum řádek. Typické použití: rozvaha rozepsaná po účtech, přehled pohybů po střediscích.

Kdy skupiny použít

• Tabulka v dokumentu obsahuje data z více skupin (účty, střediska, typy), ale XML je ploché (ne hierarchické)
• Chcete nad každou skupinou vytisknout záhlaví (název účtu, středisko...)
• Chcete mezisoučty za skupinu a celkový součet na konci

Alternativa: Pro velké sestavy s mnoha skupinami zvažte tabulkovou sestavu ("renderer": "table") se skupinami — ta má více možností (tableBreak, reprintHeader, XLSX, víceúrovňové skupiny).

Příklad: Rozvaha po účtech

{
  "type": "table",
  "element": "data",
  "detailBorders": "h-dashed",
  "groups": [{
    "groupExpression": "ucet",
    "label": "Účet {ucet} — {ucty.nazev}",
    "headerBackground": "#e8f4fc",
    "detailBorders": "h-dashed",
    "sumExpressions": [
      { "field": "castka", "expr": "SUM(castka)", "format": "N2" }
    ],
    "sumLabel": "Celkem {ucet}",
    "sumBackground": "#f0f0f0"
  }],
  "columns": {
    "text":   { "label": "Popis" },
    "castka": { "label": "Částka", "align": "right", "format": "N2" }
  },
  "sumExpressions": [
    { "field": "castka", "expr": "SUM(castka)", "format": "N2" }
  ],
  "sumLabel": "Celkem za všechny účty"
}

FoxPro příprava dat:

*--- Data musí být setříděna podle groupExpression ---
SELECT ucet, text, castka FROM ucetni_data ORDER BY ucet INTO CURSOR tmpData
CURSORTOXML("tmpData", "lcXml", 3, 16)
loBuilder.AddElementWithXmlContent("data", lcXml)

Vlastnosti skupiny

detailBorders — styl čar

Vlastnost detailBorders řídí čáry mezi datovými řádky. Nastavuje se na bloku ("type": "table") nebo na skupině (přepíše blokové nastavení):

Příklad — různé styly pro různé skupiny:

{
  "type": "table",
  "element": "polozky",
  "detailBorders": "all",
  "groups": [
    {
      "groupExpression": "kategorie",
      "label": "Kategorie: {kategorie}",
      "detailBorders": "h-dashed"
    }
  ],
  "columns": { ... }
}

Důležité

Data musí být předem setříděná podle groupExpression. Renderer pouze detekuje změny — netřídí data sám. V FoxPro použijte ORDER BY ucet (nebo více polí pro compound klíč).

Grand total se vykreslí z block.sumExpressions po všech skupinách. Pokud nechcete grand total, nevyplňte block.sumExpressions.

Skupiny v dokumentu vs. tabulkové sestavě: Skupiny v document rendereru jsou jednoduchá plochá grupování (jedna úroveň). Pro víceúrovňové skupiny, XLSX export, page break po skupině nebo headerMode external/inline použijte tabulkovou sestavu ("renderer": "table").

Víceřádková patička skupiny (sumRows)

Pro zobrazení více sum řádků za skupinou (celkem, splatné, po splatnosti) použijte sumRows místo jednoduchého sumExpressions + sumLabel:

{
  "groups": [{
    "groupExpression": "mena",
    "label": "Měna: {mena}",
    "sumRows": [
      {
        "sumLabel": "Celkem {mena}",
        "sumExpressions": [{ "field": "castka", "expr": "SUM(castka)", "format": "N2" }],
        "sumBorder": "solid"
      },
      {
        "sumLabel": "Splatné",
        "where": "stav=S",
        "sumBorder": "none",
        "style": "light"
      },
      {
        "sumLabel": "Po splatnosti",
        "where": "stav=P",
        "sumBorder": "none",
        "hideIfZero": true
      }
    ]
  }]
}

• where — filtruje řádky skupiny (jen stav=S se počítá do „Splatné")
• hideIfZero — řádek se přeskočí pokud jsou všechny součty nulové
• style: "light" — menší, šedý font (ne tučný)
• sumBorder — styl čáry: "solid" (výchozí pro první), "dashed", "light", "none"
• Druhý a další sumRow dědí sumExpressions z prvního, pokud je neuvede

Příklad: Kompletní faktura

{
  "version": "1.0",
  "document": {
    "title": "FAKTURA – daňový doklad",
    "culture": "cs-CZ",
    "overflow": "auto",
    "pageMarginMm": 8
  },
  "pageHeader": {
    "left": "EFES spol. s r.o.",
    "right": "Strana {page} z {pages}",
    "fromPage": 2
  },
  "blocks": [
    {
      "type": "columns",
      "ratio": "30:70",
      "verticalAlign": "center",
      "columns": [
        { "blocks": [{ "type": "image", "file": "logo.jpg", "maxWidthMm": 35 }] },
        { "blocks": [{ "type": "text-block", "lines": ["F A K T U R A - daňový doklad"], "style": "title" }] }
      ]
    },
    { "type": "separator", "style": "thick" },
    {
      "type": "header-two-column",
      "left": {
        "title": "DODAVATEL",
        "element": "dodavatel",
        "fields": [
          { "field": "nazev", "style": "title" },
          { "field": "ulice" },
          { "template": "{psc}  {mesto}" },
          { "separator": true },
          { "label": "IČO", "field": "ico" },
          { "label": "DIČ", "field": "dic" }
        ]
      },
      "right": {
        "title": "ODBĚRATEL",
        "element": "odberatel",
        "bordered": true,
        "fields": [
          { "field": "nazev", "style": "title" },
          { "field": "ulice" },
          { "template": "{psc}  {mesto}" },
          { "separator": true },
          { "label": "IČO", "field": "ico" },
          { "label": "DIČ", "field": "dic" }
        ]
      }
    },
    {
      "type": "info-grid",
      "element": "doklad",
      "columns": 2,
      "borderless": true,
      "items": [
        { "label": "Číslo faktury",     "field": "cislo",     "style": "title" },
        { "label": "Variabilní symbol", "field": "vs" },
        { "separator": true },
        { "label": "Způsob úhrady",     "template": "Příkazem k úhradě" },
        { "label": "Den splatnosti",    "field": "splatnost", "format": "dd.MM.yyyy", "style": "bold" }
      ]
    },
    {
      "type": "table",
      "element": "polozky",
      "primary": true,
      "showRowNumbers": true,
      "columns": {
        "nazev": { "label": "Název" },
        "pocet": { "label": "Množství", "align": "right", "format": "N2", "width": "60px" },
        "mj":    { "label": "MJ",       "align": "center", "width": "30px" },
        "jc":    { "label": "Cena/ks",  "align": "right", "format": "N2", "width": "80px" },
        "cena":  { "label": "Celkem",   "align": "right", "format": "N2", "width": "90px" }
      },
      "sumExpressions": [
        { "field": "cena", "expr": "SUM(cena)", "format": "N2" }
      ],
      "sumLabel": "Celkem"
    },
    {
      "type": "total-amount",
      "element": "doklad",
      "field": "celkem_s_dph",
      "label": "Celkem k úhradě",
      "format": "N2",
      "suffix": "Kč",
      "style": "large"
    },
    {
      "type": "text-block",
      "element": "dodavatel",
      "lines": ["{rejstrik}"],
      "style": "small"
    },
    { "type": "separator" },
    {
      "type": "signature",
      "left": "Vystavil: {doklad.vystavil}",
      "right": "Razítko a podpis dodavatele:\nPřevzal: _______________"
    }
  ]
}

Řešení problémů

Nic se nezobrazuje / prázdný dokument

• Zkontrolujte, že element v blocích odpovídá názvům XML elementů (case-sensitive)
• Zkontrolujte, že JSON je validní — VS Code zobrazí červené podtržení u chyby
• Ověřte, že blocks je pole (hranatá závorka [...])

Tabulka nemá řádky

• Zkontrolujte, že element v bloku table ukazuje na XML element s <row> potomky
• Pokud používáte primary: true, ověřte, že element opravdu existuje (jinak attachment mode selže)

Chybí pole v adrese / info-gridu

• Pokud je XML hodnota prázdná, řádek se automaticky skryje (auto-hiding)
• Pro pole, která se mají zobrazit i prázdná, použijte template místo field (template se nezakrývá)
• Zkontrolujte, že field odpovídá přesně názvu XML atributu

Faktura přetéká přes stránku

• Nastavte "overflow": "auto" v sekci document — automaticky rozhodne o stránkování
• Pro hodně položek se automaticky aktivuje attachment mode (strana 1 = hlavička, strany 2+ = tabulka)
• Případně zkontrolujte pageMarginMm — velké okraje zmenšují obsah

JSON nejde uložit / červené podtržení

• Nejčastější chyba: čárka za poslední položkou v {} nebo []
• Chybějící uvozovky: label: Faktura → "label": "Faktura"
• Chybějící čárka mezi položkami
• VS Code: Ctrl+Z vrátí zpět poslední změnu

Bloky se zobrazují ve špatném pořadí

• Pořadí bloků v poli blocks = pořadí vykreslování shora dolů
• Přesuňte blok (vyřízněte a vložte) na správné místo v poli

Časté úpravy — rychlý přehled

Příklad: Jak přidat nový blok

Vložte nový objekt do pole blocks na požadované místo:

"blocks": [
  { "type": "header-two-column", ... },
  { "type": "separator" },
  { "type": "info-grid", ... },
  { "type": "spacer", "heightMm": 5 },
  { "type": "table", ... }
]

Příklad: Jak podmíněně skrýt blok

{
  "type": "info-grid",
  "visibleWhen": "header.je_cizi_mena",
  "element": "doklad",
  "items": [
    { "label": "Měna", "template": "{header.mena}" },
    { "label": "Kurz", "field": "kurz", "format": "N3" }
  ]
}

Celý blok se zobrazí jen pokud header.je_cizi_mena má neprázdnou hodnotu.

Tipy pro VS Code

1. Ctrl+Space kdekoli → nabídne dostupné vlastnosti podle schématu
2. Ctrl+Shift+B → ruční renderování (pokud automatické nefunguje)
3. Červeně podtržené = chyba v JSON → opravte a uložte
4. Ctrl+Z → zpět (pokud se něco pokazilo)
5. Formátování JSON: Shift+Alt+F (zarovná odsazení)

Pozor: Za poslední položkou v {} nebo [] nesmí být čárka. Toto je nejčastější chyba při editaci JSON.